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THE PLASMA DISPLAY MANAGER SETSHADE 


The Plasma Display Manager diskette comes with your system and contains 
the utility SETSHADE.COM. This utility enhances the gray-scale graphing 
capability of the PowerMate® Portable SX gas plasma display. The mono- 
chrome display can use up to 16 gray shades to emulate color palettes sup- 
plied by application programs. Working with these color palettes, SET- 
SHADE automatically translates the color values into unique gray shade 
intensities to provide sharp gray-scale graphics. 


SETSHADE combines the following features. 


® Two modes of operation: 


- Automatic Mode (running SETSHADE as a memory-resident 
utility) 


- Manual Mode (running SETSHADE from the MS-DOS® 
command prompt or from a batch file). 


@ Manual Mode override of Automatic Mode for fine-tuning the 
automatic selections. 


@ Simple user interface. 


e Hot key to invoke the Manual Adjust pop-up window when the 
utility is permanently installed. 


e On-line help menus. 
@ Command line options. 


e Ability to toggle output (color or monochrome) to an external dis- 
play. 

e Ability to re-position the program display horizontally on the screen. 

e@ Support for all standard EGA modes. 


e High-memory installation. Uses no system RAM when permanently 
installed. 


REQUIREMENTS AND RESTRICTIONS 


SETSHADE imposes the following requirements and restrictions. 


e@ The utility functions only when the PowerMate Portable SX is con- 
figured for Plasma Display Mode operation. To enable the Plasma 
Display Mode in your system, you must set switch 6 on switch bank 
SW2 to ON. 


SCREEN MODE 


ON: PLASMA MODE 
OFF: CRT MODE 


Additional switch setting information is found on page 40 of your 
PowerMate Portable SX Owner’s Guide. 


@ When SETSHADE is permanently installed, it loads into the 
E000:0000 to E000:FFFF range of high memory. If an option ROM 
is already installed in this range, SETSHADE will not load and an 
error message is displayed. 


e@ SETSHADE can be used only with DOS version 3.3 or higher. 


@ SETSHADE does not support the Hercules®, MDA, and CGA emu- 
lation modes. 


e Applications that directly program the hardware without updating 
the BIOS data area may produce partial displays, or no display, of 
the Manual Adjust pop-up window. If this problem occurs, continu- 
ously press the Ctrl-Alt-Tab hot-key combination followed by Esc 
until the Manual Adjust pop-up window is displayed properly. 
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INSTALLATION 
SETSHADE can be 


e installed permanently in high memory 


® installed on your hard drive and run as a DOS utility from either the 
DOS prompt or a batch file 


e@ run as a DOS utility from drive A. 


Automatic Mode Description 


Permanent installation loads SETSHADE into high memory and turns Auto- 
matic Mode ON. Automatic Mode operation is recommended if you want 
SETSHADE to be running in the background every time you start the sys- 
tem. In Automatic Mode, SETSHADE selects a unique gray shade intensity 
for each palette color displayed on the screen by a particular application. 


In most cases, the values selected by Automatic Mode will be the optimal 
gray shade choices and you will not need to adjust them manually. How- 
ever, you can override Automatic Mode to fine-tune the automated gray 
shade settings. This feature is explained in “MANUAL MODE OVER- 
RIDE.” 


Manual Mode Description 


Installing SETSHADE on your hard drive allows you to run the utility in 
Manual Mode from either the DOS prompt or a batch file such as 
AUTOEXEC.BAT. 


Manual Mode operation is recommended for the following reasons. 


© You can adjust individual gray shades for greater control. If the dif- 
ference between two gray shades is marginal, you can spread them 
out manually for sharper contrast. 


@ Manual Mode ensures full system performance, which decreases 
slightly with the automatic mapping of palette colors to gray shades. 


e® You can set the gray shade intensities once for a particular applica- 
tion and then leave them alone. 


Installing SETSHADE Permanently in the System 
To install SETSHADE permanently in the system, follow these steps. 


1. Boot from DOS. 
2. Insert the SETSHADE diskette in drive A. 


3. Enter the following command at the A> prompt: 


SETSHADE /P [/C] 


Note that in the DOS command line, items 
in brackets — [ ] — are optional. 


Options 

/P Installs the utility permanently in your system and 
sets Automatic Mode ON. You can then display the 
Manual Adjust pop-up window by pressing Ctrl- 
Alt-Tab simultaneously. 

IC Toggles output to an external display from color to 


monochrome or monochrome to color. The default 
at power-on is monochrome. 
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Installing SETSHADE on Your Hard Drive 
Copy SETSHADE to your hard drive as follows. 


1. Boot from DOS. 
2. Insert the SETSHADE diskette in drive A. 


3. Copy SETSHADE.COM onto your hard drive by using the DOS 
Copy command. For example, the following command copies SET- 
SHADE to the UTIL subdirectory of drive C. 


Copy A:SETSHADE.COM C:\UTIL 


For more information on copying files, see the Copy command in your MS- 
DOS User’s Guide. 


RUNNING SETSHADE FROM THE DOS PROMPT 


You can run SETSHADE from drive A when the SETSHADE diskette is 
inserted or from drive C when SETSHADE is installed on your hard drive. 


To run SETSHADE, enter the following command at the DOS prompt: 
SETSHADE [s1 s2 s3 s4 s5 s6 s7 s8 s9 s10 s11 s12 $13 s14 $15 $16] 
[/C} [/?] [/H] 


Note that in the DOS command line, items 
in brackets — [ ] — are optional. 


Options 

si...s16 Specifies 16 shades of gray as initial gray shade val- 
ues for a given application. Note that all 16 values 
must be entered and specified as hexadecimal digits 
0 through F. 

LE Toggles output to an external display from color to 
monochrome or monochrome to color. The default 
at power-on is monochrome. 

/? or /H Requests a help message. 


RUNNING SETSHADE FROM A BATCH FILE 


You can run SETSHADE from a batch file if you install SETSHADE on 
your hard drive. Batch files let you execute a sequence of commands by 
simply entering the name of the batch file. Putting SETSHADE in a batch 
file is useful if you want to specify the gray shade intensities for a particular 
application. 


The following steps show you how to create a batch file named 
SET123.BAT that executes SETSHADE, specifies 16 gray shade values, 
and executes Lotus 1-2-3.® 


1. Type the following command, and press Enter. 


COPY CON SET123.BAT 


This command tells DOS to copy the information from the console 
(keyboard) to the file SET123.BAT. 


2. Type the following lines, pressing Enter after each line. 


PATH = C:\UTIL;\123 
SETSHADEO28A46CE134B57DF 
LOTUS 


The Path command tells DOS where to find SETSHADE and Lotus 
in your directory system. In this example, assume that SETSHADE 
is in a subdirectory named UTIL and Lotus is in a subdirectory 
named 123. 


The SETSHADE and LOTUS commands tell DOS to run these 
programs. In the SETSHADE command line, numbers 0 through F 
represent 16 different gray shade intensities. 


3. Press Ctrl-Z and press Enter to save the batch file. 
To execute the file, simply enter the filename SET123 at the DOS prompt. 
Placing SETSHADE in your AUTOEXEC.BAT file is the easiest way to 
ensure that the Plasma Display Manager is running when you boot the sys- 


tem. 


For further information on creating batch files, see Batch Processing in your 
MS-DOS User’s Guide. 
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-AUTOMATIC MODE OPERATION 


When you install SETSHADE permanently in the system, Automatic Mode 
is activated and the following message appears on the screen. 


SetShade 


PowerMate Portable SX 
Plasma Display Manager 
Version x.xx.xX 


(C) Copyright 19xx 
NEC Information Systems, Inc. 


Press Ctrl-Alt-TAB to activate. 


This message tells you that SETSHADE is running in the background. At 
this point, you can either run a program from the DOS prompt or press the 
Ctrl-Alt-Tab hot key to display the Manual Adjust pop-up window shown 
on pagé 8. (You can use the hot key while working in an application pro- 
gram.) 


Automatic mode causes system perfor— 
mance to decrease slightly. Occasionally, 
you may notice a mode change in the appli- 
cation and a change in the relative dark- 
to-light intensities on the screen. This is — 
normal for Automatic Mode operation. 
You can disable. Automatic Mode at any 
time to restore full system performance. 


The Automatic Mode help menu, shown on page 10, lists all the actions that 
you can perform in Automatic Mode. To display the help menu, first press 
Ctrl-Alt-Tab. The Manual Adjust pop-up window shown on page 8 ap- 
pears. Then press F1. 


MANUAL MODE OPERATION 


When you enter SETSHADE from the DOS prompt or from a batch file, 
Manual Mode is activated and the Manual Adjust pop-up window appears 
on the screen. 


SetShade 


Fi = Help 


MANUAL ADJUST POP-UP WINDOW 


The sample window shows 16 gray shade values (01-16), with 01 being the 
darkest shade and 16 being the lightest. (Only a sampling of gray shade 
intensities is shown in the shade bars.) The cursor or position indicator ap- 
pears in the upper right corner. The current mode of operation (Auto or 
Manual) is indicated at the bottom of the window. 


The number of gray shade values that appears in the pop-up window can 
range from 2 to 16, depending on the number of colors supported by the 
video mode selected. (For information on selecting video modes, see the 
Mode command in your MS-DOS User’s Guide.) 


The Manual Mode help menu, shown on page 10, lists all the actions that 
you can perform in Manual Mode. To display the help menu, press F1. 


MANUAL MODE OVERRIDE 


Manual Mode override consists of switching from Automatic Mode to Man- 
ual Mode in order to fine-tune the gray shade intensities automatically se- 
lected by SETSHADE. 


To activate Manual Mode from Automatic Mode, first press Ctrl-Alt-Tab. 
The Manual Adjust pop-up window is displayed. Then press M to switch 
from Automatic to Manual Mode. Once you have manually adjusted the 
gray shade intensities, press Enter to save the settings. When you press Esc 
to exit the session, Manual Mode is enabled and full system performance is 
restored. 


To restore the default palette values for your application, take one of the 
actions below. 


@ Exit and then re-enter the application. This allows the application to 
reset the palette values. (The gray shade values are not affected.) 


®@ Issue a display mode change command, such as MODE CO80, from 
the DOS prompt. This allows the BIOS to reset the palette values. 


HELP MENUS 


Pressing F1 from the Manual Adjust pop-up window displays one of the 
help menus shown below, depending on which mode of operation is active. 


The current mode of operation (Auto or Manual) is indicated at the bottom 


SetShade 


Action 


Select 
Adjust 
Cancel 
Reset 
Save 


Move 
Move 


Wow 


Mono 


Auto 
Manual 


F1 


ou 


AUTOMATIC MODE HELP MENU 


of the menu. 
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SetShade 


Action 


Select 
Adjust 
Cancel 
Reset 
Save 


Move 
Move 


Mono 
Fi 


Return 


MANUAL MODE HELP MENU 
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The help menu action keys are described below. 


Key 


Action 


Moves the cursor up to select a shade intensity bar. 
Moves the cursor down to select a shade intensity bar. 
Lightens or brightens the gray shade. 

Darkens or dims the gray shade. 

Cancels the SETSHADE session and returns you to DOS. 
Returns the gray shade settings to previous levels. 

Saves the gray shade settings. 

Moves the program display to the right. 

Moves the program display to the left. 


Toggles output (color or monochrome) to an external dis- 
play. 

Returns you to the Manual Adjust pop-up window. 
Activates Automatic Mode. 


Activates Manual Mode. 


You must press F1 to exit Help Mode be- 
fore you can use the action keys. 


11 


ERROR MESSAGES 


This section explains the messages that may appear when you run SET- 
SHADE. 


SetShade has been previously installed. 
This message appears when you try to execute SETSHADE from DOS after 
the utility has been permanently installed in the system. 


New Values loaded. 
This message appears when you change the gray shade intensities by running 
SETSHADE from a batch file. 


ERROR: Invalid command line! 
Invalid characters appear in the SETSHADE command line. Refer to the 
INSTALLATION section and re-enter the SETSHADE command. 


Usage: SetShade [/P][s1l s2 s3 s4 s5 s6 s7 s8 s9 s10 sll s12 s13 s14 s15 
s16]..Where..For example... 

The command line syntax or format has been violated. Refer to the IN- 
STALLATION section and re-enter the SETSHADE command. Note that 
the shade values entered from the command line must be the hexadecimal 
digits 0 through F. 


SetShade is only to be used with the NEC PowerMate Portable SX with 
the Plasma-Screen enabled. Aborting! 


Before installing SETSHADE, enable the plasma display mode by setting 
SW2-6 to ON, as explained on page 40 in your owner’s guide. 


Incorrect DOS version for the permanent installation of SetShade! 
Aborting! 
DOS version 3.3 or higher is required to install SETSHADE permanently. 


SetShade requires the NEC PowerMate Portable SX with the Plasma- 
Screen. Aborting! 

This message appears if you try to run SETSHADE on any system other 
than the PowerMate Portable SX. 
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SetShade does not support the current Video Mode. 


SETSHADE is designed to execute in any of the standard EGA modes. It 
does not support the Hercules, MDA, or CGB emulation modes. 


SetShade cannot be used with an option ROM installed at E0000h! If 
you desire to use SetShade, consult your option board manual to deter- 
mine how to leave the EQ000-EFFFFh memory area free. 

This message appears if you cannot install SETSHADE permanently in the 
system. 
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